home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / bbs / c342p22.lha / error.reasons < prev    next >
Text File  |  1994-01-04  |  5KB  |  93 lines
  1.                              Citadel Errors & problems List
  2.  In general, if you get an error and this list does not tell you how to
  3.  correct it, collect as much information as possible and report what
  4.  happended either directly to me or in the Citadel 68k room.  The first
  5.  thing to look for is a file called debug.sys or crash.sys.  These files
  6.  should appear in either your audit area, the home area, or the location
  7.  you started up Citadel.  I usually will want the information in these
  8.  files(even if it is just a cryptic one line message like "dependant variables
  9.  mismatch", sometimes it tells me exactly where the problem is).  The second
  10.  thing I will tell you to do is turn on debug, Here is a general method I
  11.  end up telling people:
  12.  
  13.      1) go into the Sysop menu, turn on debug "D" option.
  14.      2) Shut down your Citadel, "X" option.
  15.      3) delete debug.sys in the audit area(or save it if it contains
  16.         info I might need.  At the least, edit the file and add some
  17.         markers (like two lines of asterisks) at the end of the file.
  18.      4) Bring up Citadel and attempt to reproduce the problem.  If you
  19.         cannot do it locally, you might even ask a remote user to do it
  20.         for you.  leave debug on.  Note:  If you run confg, debug is
  21.         automatically turned off, repeat the above steps.
  22.      5) archive all the information(using something like lha) and arrange
  23.         to get the information to me.  I may call your BBS to download the
  24.         file so make some arrangements in Citadel 68K so I know where it
  25.         is.
  26.  
  27.  
  28.  Error:  [1]IOError = nnnn
  29.  Error:  [2]IOError = nnnn
  30.  Reason:  nnnn is a result code returned from a serial port i/o, usually
  31.           a dropped carrier(small timing window for a race condition could
  32.           cause this).  The error is handled for 99% of the cases in a way
  33.           that will cause Citadel to recover and reset.  [1] is the case
  34.           where i check to see what is in the serial port buffer, and [2]
  35.           is when the actual read is done.
  36.  
  37.  Error:   Startup Error Code nn
  38.  Reason:  something went wrong during system initialization. The reasons
  39.           are:
  40.           1 - unable to open intuition.library, you must be 1.2 or greater
  41.               to run Citadel.
  42.           2 - unable to open graphics.library, same as 1, or could
  43.               not open req.library, check your libs: for req.library, it
  44.               is required for Citadel operation.
  45.           3 - Insufficient Stack space, Citadel versions 3.42.E19 and
  46.               earlier required a large stack, much larger than needed
  47.               (50K).  Versions 3.42.E20 and later will require a 20K
  48.               stack or less(I am still adjusting the values down).
  49.               3.43 will probably require an 8K stack since all the tests
  50.               I have done show a 3 k stack is enough.  Citadel still
  51.               requires the larger limits.
  52.          11 - Console Open Error.  Catch all for console window errors
  53.               If you are using #WBSCREEN, try without it.
  54.          25 - Open Serial Port Failed, Well, Citadel could not get to
  55.               the serial port(maybe something else has it open, or you
  56.               have Citadel running twice?).
  57.          31 - Could not create a Port for timer communications, Low
  58.               memory?  Trashed system tables?  Try a re-boot.  This is
  59.               one of those, "you should never get here".  If you bug me
  60.               with this type of problem, you had better have a full
  61.               system configuration and alot of details.
  62.          32 - could not create an I/O request. See 31.
  63.          33 - Open timer.device failed.  See 31.
  64.  
  65.   Note:  In the serial port open errors, and in most cases with debug
  66.   turned on, you will get a text error message of the form:
  67.  
  68.    1:    Date - Dos Error:nnnn
  69.    2:    (some text as to what happened)
  70.    3:    (some text as to what happened) <-- you may get only one line.
  71.    4:    Reason: <error text>
  72.    5:    Current Directory
  73.  
  74.    Line 1: is the internal error code(less than 100), or the Dos error
  75.    code.
  76.    Lines 2-3: will either be a command(like in the external protocols) and
  77.    a text line, or just one line of text.  External commands will display
  78.    the text and command, most errors do not have an external command.
  79.    4: is the reason the error occured(from the Exec routine Fault).
  80.    5: is the current directory.  This is important if you are trying to
  81.       setup a door for example and in the wrong directory.
  82.  
  83.  If the problem is reproducable, do it several times and record all possible
  84.  information, especially your system configuration!  If it happens just
  85.  once and you can not reproduce it, then still record what you can, check
  86.  things like memory in use, what is running.
  87.  
  88.  Note:  If you have a problem that seems to happen often, realize that I
  89.  rarely have a crash.  Pleae check to see that something else is not causing
  90.  the problem.  Remove commodities, other programs and see if you can cause
  91.  the problem without that super-duper-whiz-bang mouse accelerator/screen
  92.  blanker!  It probably ain't Citadel!
  93.